gtkbindings: Clarify that widgets need has-focus for bindings to work

https://bugzilla.gnome.org/show_bug.cgi?id=770242

diff --git a/gtk/gtkbindings.c b/gtk/gtkbindings.c
index 54515d3e0deeb6930a48a5682abd59b31914f3ca..f71fcac335c65ac93b0ad3d6b2bb46ea3661f9a2 100644 (file)
--- a/gtk/gtkbindings.c
+++ b/gtk/gtkbindings.c
@@ -47,6 +47,12 @@
  * with high key  binding configurability which requires no application
  * or toolkit side changes.
  *
+ * In order for bindings to work in a custom widget implementation, the
+ * widget’s #GtkWidget:can-focus and #GtkWidget:has-focus properties
+ * must both be true. For example, by calling gtk_widget_set_can_focus()
+ * in the widget’s initialisation function; and by calling
+ * gtk_widget_grab_focus() when the widget is clicked.
+ *
  * # Installing a key binding
  *
  * A CSS file binding consists of a “binding-set” definition and a match